Inside Macintosh: QuickDraw GX Objects /

Chapter 6 - Transform Objects / Transform Objects Reference

Functions / Getting and Setting the View Port List

GXSetTransformViewPorts

You can use the GXSetTransformViewPorts function to assign a view port list to a transform object.

void GXSetTransformViewPorts(gxTransform target, long count,
                              const gxViewPort list[]);

target

A reference to the transform object to which you want to assign the view port list.

count

The number of entries in the new view port list; the size of the list array.

list

The new view port list; an array of references to the view ports you want to associate with the source transform.

DESCRIPTION

The GXSetTransformViewPorts function replaces the view port list of the transform object referenced by the target parameter with the view port list contained in the list parameter. The count parameter specifies the number of view ports in the new list.

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory
transform_is_nil
invalid_viewPort_reference
parameter_out_of_range	(debugging version)
Notices (debugging version)
transform_viewPorts_already_set

SEE ALSO

For an example of the use of this function, see Listing 6-6 on page 6-29.

To retrieve the view port list of a transform object, use the GXGetTransformViewPorts function, described in the previous section.

To assign a view port list to the transform object associated with a specified shape, use the GXSetShapeViewPorts function, described on page 6-76.